home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / arcf.z / arcf
Encoding:
Text File  |  2002-10-03  |  6.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaarrrrccccffff((((3333GGGG))))                                                              aaaarrrrccccffff((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      aaaarrrrccccffff,,,, aaaarrrrccccffffiiii,,,, aaaarrrrccccffffssss - draw a filled circular arc
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd aaaarrrrccccffff((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss,,,, ssssttttaaaarrrrttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg))))
  13.      CCCCoooooooorrrrdddd xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss;;;;
  14.      AAAAnnnngggglllleeee ssssttttaaaarrrrttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg;;;;
  15.  
  16.      vvvvooooiiiidddd aaaarrrrccccffffiiii((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss,,,, ssssttttaaaarrrrttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg))))
  17.      IIIIccccoooooooorrrrdddd xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss;;;;
  18.      AAAAnnnngggglllleeee ssssttttaaaarrrrttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg;;;;
  19.  
  20.      vvvvooooiiiidddd aaaarrrrccccffffssss((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss,,,, ssssttttaaaarrrrttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg))))
  21.      SSSSccccoooooooorrrrdddd xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss;;;;
  22.      AAAAnnnngggglllleeee ssssttttaaaarrrrttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg;;;;
  23.  
  24.      All of the routines named above are functionally the same.  They differ
  25.      only in the type assignments of their parameters.
  26.  
  27. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  28.      _x          expects the _x coordinate of the center of the filled arc. The
  29.                 center of the filled arc is the center of the circle that
  30.                 would contain the arc.
  31.  
  32.      _y          expects the _y coordinate of the center of the filled arc. The
  33.                 center of the filled arc is the center of the circle that
  34.                 would contain the arc.
  35.  
  36.      _r_a_d_i_u_s     expects the length of the radius of the filled arc.  The
  37.                 radius of the filled arc is the radius of the circle that
  38.                 would contain the filled arc.
  39.  
  40.      _s_t_a_r_t_a_n_g   expects the measure (in tenths of a degree) of the start angle
  41.                 of the filled arc.  The start angle of the filled arc is
  42.                 measured relative to the positive x-axis.
  43.  
  44.      _e_n_d_a_n_g     expects the measure (in tenths of a degree) of the end angle
  45.                 of the filled arc.  The end angle of the filled arc is
  46.                 measured relative to the positive x-axis.
  47.  
  48. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  49.      aaaarrrrccccffff draws a filled circular arc in the _x-_y plane (_z = _0).  The filled
  50.      area is bound by the arc and by the start and end radii. To draw an arc
  51.      in a plane other than the _x-_y plane, define the arc in the _x-_y plane and
  52.      then rotate or translate the arc.
  53.  
  54.      An arc is drawn as a single polygon, and therefore inherits all
  55.      properties that affect the drawing of polygons.  These include the
  56.      current color, writemask, fill pattern, shade model, polygon antialiasing
  57.      mode, polygon scan conversion mode, and subpixel mode.  Front-face and
  58.      back-face elimination work correctly with filled arcs, which are front-
  59.      facing when viewed from the positive z half-space.  Some polygon modes
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaarrrrccccffff((((3333GGGG))))                                                              aaaarrrrccccffff((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      are applicable only if old-style scan conversion is defeated.  (See note
  75.      below.)
  76.  
  77.      A filled arc is defined in terms of the circle that contains it.  All
  78.      references to the radius and the center of the filled arc refer to the
  79.      radius and center of the circle that contains the filled arc. The angle
  80.      swept out by the filled arc is the angle from the start angle counter-
  81.      clockwise to the end angle.
  82.  
  83.      The start and end angles are defined relative to the positive x-axis. (To
  84.      speak more precisely, because the arc might not be centered on the
  85.      origin, the start and end angles are defined relative to the right
  86.      horizontal radius of the circle containing the arc.)  Positive values for
  87.      an angle indicate a counter-clockwise rotation from the horizontal.
  88.      Negative values indicate a clockwise rotation from the horizontal.
  89.  
  90.      The basic unit of angle measure is a tenth of a degree. The value 900
  91.      indicates an angle of 90 degrees in a counter-clockwise direction from
  92.      the horizontal. Thus, a filled arc that spans from a start angle of 10
  93.      degrees (_s_t_a_r_t_a_n_g = _1_0_0) to an end angle of 5 degrees (_e_n_d_a_n_g = _5_0) is
  94.      almost a complete filled circle.
  95.  
  96.      After aaaarrrrccccffff executes, the graphics position is undefined.
  97.  
  98. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  99.      arc, backface, bgnpolygon, circf, frontface, glcompat, polymode,
  100.      polysmooth, scrsubdivide, setpattern, shademodel, subpixel
  101.  
  102. NNNNOOOOTTTTEEEE
  103.      By default aaaarrrrccccffff draws a polygon using the old-style scan conversion
  104.      algorithm, rather than the point sampling algorithm used by bbbbggggnnnnppppoooollllyyyyggggoooonnnn
  105.      and eeeennnnddddppppoooollllyyyyggggoooonnnn.  Point sampling is prefered over old-style scan
  106.      conversion because it has higher performance, it results in higher-
  107.      quality images when blending, logical operations, or stenciling are used,
  108.      and it supports new rendering features such as texture mapping, fog, and
  109.      antialiasing.  Call ggggllllccccoooommmmppppaaaatttt((((GGGGLLLLCCCC____OOOOLLLLDDDDPPPPOOOOLLLLYYYYGGGGOOOONNNN,,,,0000)))) to enable point sampling
  110.      of polygons generated by aaaarrrrccccffff.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.